OLA 文档中心

主题

2026-06-10

图片比较-结构相似性指数 - CalculateSSIM ​

函数简介 ​

获取两张图片的结构相似性指数。

接口名称 ​

CalculateSSIM

DLL调用 ​

double CalculateSSIM(long ola, long imgPtr1, long imgPtr2);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
imgPtr1长整数型第一个OLAImage对象的地址
imgPtr2长整数型第二个OLAImage对象的地址

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long img1 = ola.LoadImage("images/scene.png");
long img2 = ola.LoadImage("img/template.bmp");
if (img1 != 0 && img2 != 0) {
    double val = ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1);
    ola.FreeImage(img2);
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long img1 = ola.LoadImage("images/scene.png");
long img2 = ola.LoadImage("img/template.bmp");
if (img1 != 0 && img2 != 0)
{
    double val = ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1);
    ola.FreeImage(img2);
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
img1 = ola.LoadImage("images/scene.png")
img2 = ola.LoadImage("img/template.bmp")
if img1 and img2:
    val = ola.CalculateSSIM(img1, img2)
    # 后续不再使用该图时释放
    ola.FreeImage(img1)
        # 后续不再使用该对比图时释放
    ola.FreeImage(img2)
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.MatchResult;
import java.util.List;

OLAPlugServer ola = new OLAPlugServer();
long img1 = ola.LoadImage("images/scene.png");
long img2 = ola.LoadImage("img/template.bmp");
if (img1 != 0 && img2 != 0) {
    ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1);
    ola.FreeImage(img2);
}
cpp
var ola = com("OlaPlug.OlaSoft")
var img1 = ola.LoadImage("images/scene.png")
var img2 = ola.LoadImage("img/template.bmp")
if(img1 && img2) {
    ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1)
    ola.FreeImage(img2)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
img1 = ola.LoadImage("images/scene.png")
img2 = ola.LoadImage("img/template.bmp")
If img1 <> 0 And img2 <> 0 Then
    ola.CalculateSSIM(img1, img2);
    ' 后续不再使用该图时释放
        ' 后续不再使用该对比图时释放
    ola.FreeImage(img1)
    ola.FreeImage(img2)
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
img1 ＝ ola.LoadImage ("images/scene.png")
img2 ＝ ola.LoadImage ("img/template.bmp")
    ola.CalculateSSIM(img1, img2);
    ' 后续不再使用该图时释放
    ola.FreeImage (img1)
        ' 后续不再使用该对比图时释放
    ola.FreeImage (img2)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var img1 = ola.LoadImage("images/scene.png");
var img2 = ola.LoadImage("img/template.bmp");
if(img1 && img2){
    ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1);
    ola.FreeImage(img2);
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 img1 = ola.LoadImage("images/scene.png")
长整数 img2 = ola.LoadImage("img/template.bmp")
    ola.CalculateSSIM(img1, img2);
    ' 后续不再使用该图时释放
        ' 后续不再使用该对比图时释放
    ola.FreeImage(img1)
    ola.FreeImage(img2)
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long img1 = ola.LoadImage("images/scene.png");
long img2 = ola.LoadImage("img/template.bmp");
if (img1 != 0 && img2 != 0) {
    ola.CalculateSSIM(img1, img2);
    // 后续不再使用该图时释放
        // 后续不再使用该对比图时释放
    ola.FreeImage(img1);
    ola.FreeImage(img2);
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
CalculateSSIM(instance, img1, img2);
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern double CalculateSSIM(long ola, long image1, long image2);

long instance = CreateCOLAPlugInterFace();
double val = CalculateSSIM(instance, img1, img2);
python
from ctypes import CDLL, c_int64
ola = CDLL("OLAPlug_x64.dll")
instance = ola.CreateCOLAPlugInterFace()

返回值 ​

双精度浮点数，范围0到1，值越大表示图像越相似。